<!DOCTYPE html>
<html lang="en" dir="ltr">
<head>
  <meta charset="utf-8" />
  <title>opencpn:opencpn_user_manual:plugins:included_plugins:grib_weather</title>
<meta name="generator" content="DokuWiki"/>
<meta name="robots" content="noindex,nofollow"/>
<meta name="keywords" content="opencpn,opencpn_user_manual,plugins,included_plugins,grib_weather"/>
<link rel="search" type="application/opensearchdescription+xml" href="../../lib/exe/opensearch.html" title="OpenCPN Manuals"/>
<link rel="start" href="grib_weather.html"/>
<link rel="contents" href="grib_weather.html" title="Sitemap"/>
<link rel="alternate" type="application/rss+xml" title="Recent Changes" />
<link rel="alternate" type="application/rss+xml" title="Current namespace" />
<link rel="alternate" type="text/html" title="Plain HTML" href="grib_weather.html"/>
<link rel="alternate" type="text/plain" title="Wiki Markup" href="grib_weather.html"/>
<link rel="canonical" href="http://localhost/dokuwiki/doku.php?id=opencpn:opencpn_user_manual:plugins:included_plugins:grib_weather"/>
<link rel="stylesheet" type="text/css" href="../../lib/exe/css.php.t.bootstrap3.css"/>
<!--[if gte IE 9]><!-->
<script type="text/javascript">/*<![CDATA[*/var NS='opencpn:opencpn_user_manual:plugins:included_plugins';var JSINFO = {"id":"opencpn:opencpn_user_manual:plugins:included_plugins:grib_weather","namespace":"opencpn:opencpn_user_manual:plugins:included_plugins","confirm_delete":"Are you sure you want to delete this page?","doku_base":"\/dokuwiki\/","cg_rev":"","dw_version":49.5,"chrome_version":0,"hide_captcha_error":"none","ckg_dbl_click":"","ckg_canonical":0,"has_wrap":"Wrap","wrapDiv":"WRAP","wrapSpan":"wrap","ckgEdPaste":"off","rel_links":0,"isadmin":0,"isauth":0,"move_renameokay":false,"schemes":["http","https","telnet","gopher","wais","ftp","ed2k","irc","ldap"],"htmlok":0};
/*!]]>*/</script>
<script type="text/javascript" charset="utf-8" src="../../lib/exe/jquery.php.t.bootstrap3.js"></script>
<script type="text/javascript" charset="utf-8" src="../../lib/exe/js.php.t.bootstrap3.js"></script>
<!--<![endif]-->

    <script type="text/javascript">
    //<![CDATA[ 
    function LoadScript( url )
    {
     document.write( '<scr' + 'ipt type="text/javascript" src="../..//url"><\/scr' + 'ipt>' ) ;        

    }
   function LoadScriptDefer( url )
    {
     document.write( '<scr' + 'ipt type="text/javascript" src="../..//url" defer><\/scr' + 'ipt>' ) ;        

    }
//]]> 

 </script>
</head>
<body>
<div class="dokuwiki export">



<h1 class="sectionedit1" id="grib_weather">Grib Weather</h1>
<div class="level1">

<p>
OpenCPN has a grib weather file viewer plugin, aimed at being useful while under way.<br/>

<strong>The grib plugin is always distributed with OpenCPN, no separate download is required.</strong>
</p>

</div>
<!-- EDIT1 SECTION "Grib Weather" [20-227] -->
<h3 class="sectionedit2" id="what_is_a_grib_file">What is a grib file?</h3>
<div class="level3">

<p>
If you are not familiar with grib weather files, make sure you understand the basics, before you start to use them. <strong>It is essential to understand the limitations of weather forecasts that are distributed in the grib format.</strong> <br/>

It is also worth pointing out that gribs are <strong>not</strong> reliable near tropical systems.<br/>

Send a blank mail to GribWarning@saildocs.com. Read the mail you get back carefully.<br/>

To get started with gribs and to find sources for downloads, check <a href="http://weather.mailasail.com/Franks-Weather/Grib-Files-Getting-And-Using" class="urlextern" title="http://weather.mailasail.com/Franks-Weather/Grib-Files-Getting-And-Using" rel="nofollow">Franks-Weather</a>.<br/>

A very good, up to date book, is “Modern Marine Weather, second edition” by David Burch, with a thorough treatment of the subject.<br/>

A few files including lectures on tropical weather and gribs are available <a href="http://www.pangolin.co.nz/jetsam-index" class="urlextern" title="http://www.pangolin.co.nz/jetsam-index" rel="nofollow">here</a>.
</p>

</div>
<!-- EDIT2 SECTION "What is a grib file?" [228-1084] -->
<h3 class="sectionedit3" id="types_of_grib_files">Types of Grib files.</h3>
<div class="level3">

<p>
OpenCPN can read both the original gribfile format, known as Grib1, as well as the new Grib2 format, with the .grb2 or .grib2 file-extension.
</p>

</div>
<!-- EDIT3 SECTION "Types of Grib files." [1085-1260] -->
<h3 class="sectionedit4" id="get_started">Get started</h3>
<div class="level3">

<p>
To display grib files as an overlay on your normal charts you have to first activate the grib icon <img src="../../opencpn/manual/plugins/grib/grib.h.32_tok.7af5ea_w.32.jpg" class="media" alt="" width="32" height="32" /><br/>

Go to <img src="../../opencpn/manual/settings.h.32_tok.90bb99_w.32.jpg" class="media" alt="" width="32" height="32" /> find the plugin tab. Click on the Grib plugin, then the “Enable” button. The “Preferences” Button brings up a small dialog. The settings in this dialog rarely needs changing after the initial setup.<br/>

</p>

<p>
<img src="../../opencpn/manual/plugins/grib/33gribpreference2.h.483_tok.dfaf0f_w.340.jpg" class="media" alt="" width="340" height="483" />
</p>

</div>
<!-- EDIT4 SECTION "Get started" [1261-1762] -->
<h3 class="sectionedit5" id="grib_preference">Grib Preference</h3>
<div class="level3">

<p>
<strong>Use High Definition Graphics</strong>. The setting only concerns the barbed wind arrows.Tick the “Use High Definition Graphics” box, unless you are on old hardware. Not ticking the “High Definition Graphics” box can help to speed up the grib display on a slow computer.<br/>

<strong>Use Gradual Colors.</strong> This setting applies to all colored overlay maps. On many installations the difference in rendering is very small. The overlay maps built in color variation plays a part.<br/>

<strong>Copy First Cumulative Missing Record</strong>. This is about rainfall and cloud cover records .<br/>

As these records are “cumulative” the first one does not exist in files from zyGrib and Saildocs. With this parameter unchecked, there will be neither rainfall and nor cloud cover displayed for the first date/time of the file. Ticking the box fixes the problem.<br/>

<strong>Copy Missing Wave Records</strong>. This only concerns wave records from zyGrib delivers files from two models ; FNMOC (WW3-…) for waves and GFS for all other parameters. These two forecast models does not have the same time spacing. For some dates/times, the wave data do not exist.This parameter allows this missing data to be reconstructed and avoiding the overlay (if set) to flicker.<br/>

</p>

</div>
<!-- EDIT5 SECTION "Grib Preference" [1763-3000] -->
<h3 class="sectionedit6" id="load_file_options">Load File Options</h3>
<div class="level3">

<p>
<strong>Load the More Recent File in Directory</strong>. Loads the newest file in the grib directory on start.<br/>

<strong>Load the Last Open File</strong>. Loads the grib file used last time.<br/>

</p>

</div>
<!-- EDIT6 SECTION "Load File Options" [3001-3198] -->
<h3 class="sectionedit7" id="start_options">Start options</h3>
<div class="level3">

<p>
<strong>Start at the first forecast in GRIB file</strong><br/>

<strong>Start at the nearest forecast to current time</strong><br/>

<strong>Authorize interpolation to start at current time.</strong><br/>

</p>

</div>
<!-- EDIT7 SECTION "Start options" [3199-3380] -->
<h3 class="sectionedit8" id="time_options">Time Options</h3>
<div class="level3">

<p>
<strong>Local Time</strong><br/>

<strong>UTC</strong><br/>

</p>

</div>
<!-- EDIT8 SECTION "Time Options" [3381-3434] -->
<h2 class="sectionedit9" id="the_grib_display_controls">The Grib Display Controls</h2>
<div class="level2">

</div>
<!-- EDIT9 SECTION "The Grib Display Controls" [3435-3473] -->
<h3 class="sectionedit10" id="the_standard_display_control">The Standard Display Control</h3>
<div class="level3">

<p>
To start the Grib plugin press the <img src="../../opencpn/manual/plugins/grib/grib.h.32_tok.7af5ea_w.32.jpg" class="media" alt="" width="32" height="32" />button in the tool-bar. The “GRIB Display Control” then pops up.
</p>

<p>
<img src="../../opencpn/manual/plugins/grib/grib-menu-2.h.283_tok.4436f7_w.550.jpg" class="media" alt="" width="550" height="283" />
</p>

<p>
Hide Data at Cursor
</p>

<p>
<img src="../../opencpn/manual/plugins/grib/girb-hide-data.h.57_tok.022024_w.550.jpg" class="media" alt="" width="550" height="57" />
</p>

<p>
This is a smart and compact dialog. For a quick start press the “Open File” button and navigate to your grib file directory and press the file to be displayed. <br/>

<strong>Previous/Next</strong> Go to the previous or the next record in the gribfile. This corresponds to the time “interval” chosen when the grib file was downloaded.<br/>

<strong>Data valid at</strong> The time of validity for all grib data on screen.<br/>

<strong>Open Grib file</strong> The name of the grib file in use.<br/>

<strong>Now </strong>Displays the record, nearest in time to “now” according to the Start option you have selected: (“Start at the nearest forecast to current time” or “Authorize interpolation to start at current time”).<br/>

<strong>Select Geopotential Height </strong>If grib data for geopotential height is available, selection will be between Std, 500.<br/>

<strong>Zoom to Center</strong> This button will home in on the loaded area that the loaded grib file covers.<br/>

<strong>Play </strong>Goes through all records in turn, with the animation speed controlled in the “Grib Settings” dialog.<br/>

<strong>Hide Cursor Data </strong>Hides Grib which normally appears in the data windows. Data windows are hidden.<br/>

<strong>Progress Slider</strong> Just to the right of the “Play” button is a slider that is just another way of going through the grip records.<br/>

<strong>Open File</strong> Activates the operating systems standard file selector dialog to select a grib file. The plugin remembers the directory of this grib. This is used next time you start OpenCPN and activates the Grib plugin. See settings in the “Grib Preferences” dialog above.<br/>

<strong>Settings </strong>is where to control how the different grib data will be displayed. See more below.<br/>

<strong>Request </strong>Download grib files via email. More below.<br/>

<strong>GRIB Data at Cursor. </strong>This is where the “smart” part kicks in.<br/>

<strong>Only entries for the data contained in the active grib file will be displayed</strong>. For example, if there is no wave data in the current grib file, there will be no signs of wave data at all. In the case above, where the the wave data is N/A, the grib file includes wave data, but not for the area where the cursor is. Compare with the picture below, where the grib only contains current data. <br/>

The tick boxes next to each data entry, are used to activate the data-display on the screen. <br/>

Exactly what will be shown is controlled in the “Grib Settings” dialog, which is reached by pressing the “Settings” button. <br/>

Don&#039;t activate to many display features at the same time. The display quickly becomes very cluttered.
</p>

<p>
<img src="../../opencpn/manual/plugins/grib/33gribcurrent.h.106_tok.d53ae2_w.605.jpg" class="media" alt="" width="605" height="106" /><br/>

</p>

<p>
The “GRIB Display Control” loaded with a grib file only containing current data.
</p>

<p>
<strong>Advanced GRIB Data at Cursor</strong>. The display options for all the data shown, can be reached by right.clicking on the little squares where the “ticks” are shown. For the meaning of all these options, read on.
</p>

<p>
<img src="../../opencpn/manual/plugins/grib/4gribcontrol.h.260_tok.6d9d97_w.637.jpg" class="media" alt="" width="637" height="260" /><br/>

</p>

<p>
Right-clicking the “Air Temp” option square.
</p>

</div>
<!-- EDIT10 SECTION "The Standard Display Control" [3474-6737] -->
<h3 class="sectionedit11" id="the_advanced_display_control">The Advanced Display Control</h3>
<div class="level3">

<p>
The plugin has an advanced mode were altitude data can be displayed. This mode requires some more knowledge than plain gribs.<br/>

A good start is to read <strong><a href="http://vos.noaa.gov/MWL/dec_08/milibar_chart.shtml" class="urlextern" title="http://vos.noaa.gov/MWL/dec_08/milibar_chart.shtml" rel="nofollow">&quot;Mariner&#039;s Guide to the 500--Millibar Chart&quot;</a>.</strong> <br/>

If a grib file includes altitude data, the control will automatically include more options. See below.
</p>

<p>
<img src="../../opencpn/manual/500mb.h.216_tok.aa37b5_w.700.jpg" class="media" alt="" width="700" height="216" /><br/>

</p>

<p>
If the dialog looks normal except for an extra selection box under “GRIB Data at Cursor”, like this,
</p>

<p>
<img src="../../opencpn/manual/std-grib.h.50_tok.14d9f6_w.132.jpg" class="media" alt="" width="132" height="50" />
</p>

<p>
then the grib file contains altitude data. Selecting one of the altitudes, for example 500, changes the dialog to what you see above.<br/>

The advanced data are displayed against a yellow background.<br/>

<strong>Wind</strong>. These are the wind data valid for the selected altitude level.<br/>

<strong>Grib Data at 500 hPa</strong>. The values at the selected level.
</p>

</div>
<!-- EDIT11 SECTION "The Advanced Display Control" [6738-7673] -->
<h2 class="sectionedit12" id="weather_tables">Weather Tables</h2>
<div class="level2">

<p>
Once a grib file is loaded in the current session, the “Weather table” appears in the right click menu.
</p>

<p>
<img src="../../opencpn/manual/33wxtable.h.302_tok.382db4_w.243.jpg" class="media" alt="" width="243" height="302" />
</p>

<p>
Click the entry, and a Weather Table, valid at the cursor point, pops up. All available data in the current grib file, for the whole time span, are shown.
</p>

<p>
<img src="../../opencpn/manual/plugins/grib/grib-table-arrows.tok.c330c8_w.600.jpg" class="media" title="Grib Table Arrows" alt="Grib Table Arrows" width="600" /></a><br/>

</p>

<p>
<strong>NOTE:</strong> To change the Wind &amp; Wave Arrows to Degrees, just hit the <strong>Dir</strong> switch.
</p>

<p>
<img src="../../opencpn/manual/plugins/grib/grib-table-degrees.tok.5e4021_w.600.jpg" class="media" title="Grib Table Degrees" alt="Grib Table Degrees" width="600" /></a><br/>

</p>

</div>
<!-- EDIT12 SECTION "Weather Tables" [7674-8257] -->
<h3 class="sectionedit13" id="settings">Settings</h3>
<div class="level3">

<p>
…controls how the grib files are displayed on the screen, and units used in the Grib Display control. Things like overlay colors, animation time interval and speed and much more.
The basic dialog looks like this.
</p>

<p>
<strong>Typical DATA TAB</strong><br/>

<img src="../../opencpn/manual/plugins/grib/grib-settings-data-wind-gust.h.250_tok.9755cc_w.550.jpg" class="media" alt="" width="550" height="250" /><br/>

Note the Fixed or Minimum Spacing (pixels) selection. This is a typical setting.
</p>

<p>
<strong>Typical <abbr title="Graphical User Interface">GUI</abbr> TAB</strong><br/>

<img src="../../opencpn/manual/plugins/grib/grib-settings-data-waves-gui.h.534_tok.9cd286_w.550.jpg" class="media" alt="" width="550" height="534" />
</p>

<p>
<strong>Typical PLAYBACK TAB</strong><br/>

<img src="../../opencpn/manual/plugins/grib/grib-settings-data-waves-playback.h.223_tok.c6cdc2_w.549.jpg" class="media" alt="" width="549" height="223" /><br/>

<img src="../../opencpn/manual/plugins/grib/grib-settings-bottom-slider.h.159_tok.e12382_w.550.jpg" class="media" alt="" width="550" height="159" />
</p>

</div>
<!-- EDIT13 SECTION "Settings" [8258-8977] -->
<h3 class="sectionedit14" id="playback">Playback</h3>
<div class="level3">

<p>
The Loop Mode controls what happens when “Play” is pressed in the Grib Display Control.
</p>

<p>
<strong>Loop Mode</strong>. Sets the “Play” function into a loop mode. Otherwise, playback will stop when reaching the end of the file.<br/>

<strong>Loop Start</strong>. Were to start the loop. The option “Current time forecast” makes sure that only data now or in the future are shown<br/>

<strong>Updates per Second.</strong> Controls the speed of “play”.<br/>

<strong>Loop Start</strong>. The loop can start either at the start of the grib file or from the current time forecast.<br/>

<strong>Interpolate between gribs</strong>. If you select this option, you will be able to choose your own time interval, but you have to consider that it can decrease data accuracy. To remind you, this info will pop up.<br/>

</p>

<p>
<img src="../../opencpn/manual/plugins/grib/33gribinterpolation.h.165_tok.cdfcae_w.477.jpg" class="media" alt="" width="477" height="165" /><br/>

<strong>Time Interval</strong>. This is the time interval used for interpolation. The entry is only visible if “Interpolate between gribs” is ticked. This is connected tho the chosen time interval when requesting a grib file.<br/>

</p>

</div>
<!-- EDIT14 SECTION "Playback" [8978-10012] -->
<h3 class="sectionedit15" id="display">Display</h3>
<div class="level3">

<p>
The lower part of the Grib Settings Dialog, under the Display heading is really 10 different controls. The controls are activated by the choosing one of the items in the selection menu below.
</p>

<p>
<img src="../../opencpn/manual/plugins/grib/4gribdisplaychoices.h.308_tok.32463b_w.188.jpg" class="media" alt="" width="188" height="308" />
</p>

<p>
Many of the entries are repeated, so let&amp;#39;s first have a closer look at the the most important one, the Wind. Entries on the same line are connected.
</p>

<p>
<img src="../../opencpn/manual/plugins/grib/grib-settings-data-wind.h.399_tok.384157_w.550.jpg" class="media" alt="" width="550" height="399" />
<br/>

<img src="../../opencpn/manual/plugins/grib/grib-settings-bottom-slider.h.159_tok.e12382_w.550.jpg" class="media" alt="" width="550" height="159" />
<br/>

</p>

<p>
<strong>Units </strong>refers to the choice of units for the selected record.
<br/>

For wind speed the choices are.
</p>

<p>
<img src="../../opencpn/manual/plugins/grib/33gribunits.h.102_tok.77f7dc_w.92.jpg" class="media" alt="" width="92" height="102" /><br/>

<strong>Barbed Arrows</strong> Display the traditional barbed arrows, showing wind direction and wind speed.<br/>

<strong>Range</strong> refers to the distance between displayed arrows (not working 3.3.1117).<br/>

<strong>Default Color/Controlled Colors</strong> Default is dark brown while “Controlled” varies from blue for very light winds to red for very strong winds.
<br/>

</p>

<p>
<img src="../../opencpn/manual/plugins/grib/4gribcontroledcolours.h.187_tok.8c383f_w.300.jpg" class="media" alt="" width="300" height="187" />
<br/>

<strong>Always visible</strong> This option only exists for “Wind” and “Pressure”. When ticked the object is shown regardless of what is ticked in the “Settings Control”. The idea is to be able to Show wind and/or pressure at the same time as other options. Use with Rainfall, for example, to help identifying fronts.
<br/>

<strong>Display Isotachs</strong> shows contour lines connecting points with the same wind speed.
<br/>

<strong>Spacing</strong> controls which wind speed Isotachs will be shown. Use knots for units and 10 for spacing and isotach contours will be shown at 10 kts, 20kts and so on.
<br/>

<strong>OverlayMap</strong> Depending on your system capability,if you use “Accelerated Graphics (OpenGL)” (see General Options/Display/Advanced), the overlay will be visible at all scales. But if you don&#039;t, the overlay will only be visible at small scales. A small yellow pop up at the bottom left of the screen will inform you. Zoom out to a scale of 1:13 millions, or smaller to see them.
<br/>

<strong>Colors</strong> is another selection menu containing pre-set color schemes. The idea is to use the scheme with the same name as the control, but this is just a hint, nothing more.
<br/>

</p>

<p>
<img src="../../opencpn/manual/plugins/grib/33griboverlaycolors.h.178_tok.4ef472_w.137.jpg" class="media" alt="" width="137" height="178" />
</p>

<p>
<strong>Numbers </strong>shows the wind speed in small square boxes. <strong>Minimum Spacing</strong> refers to the spacing between these boxes.<br/>

<strong>Particle Map</strong> is a kind of animation of the wind field. It is created by letting “particles”, or dots, move in the wind direction and leave a trail. The trail is colored after the wind strength, and each particle has a limited “life span”. <br/>

The<strong> Density </strong>slider creates particle trails that are shorter but closer together with increased value, which is the same as further to the right. The particle Map below clearly shows a convergence zone with stronger winds (red). This is probably a cold front. <br/>
<strong>Performance Warning</strong>: Note that high density Particle Maps on Low Powered Machines and Large Files may slow your machine to a crawl. First test on small files.<br/>

</p>

<p>
<img src="../../opencpn/manual/particlemap.h.363_tok.6e67c6_w.549.jpg" class="media" alt="" width="549" height="363" />
</p>

<p>
<strong>Overlay Transparency</strong> works as expected.<br/>

</p>

<p>
All the controls for Wind Gust, Rainfall and Cloud Cover, have similar entries; only the units differ.
</p>

<p>
<img src="../../opencpn/manual/plugins/grib/grib-settings-data-wind-gust.h.250_tok.9755cc_w.550.jpg" class="media" alt="" width="550" height="250" />
<br/>

<img src="../../opencpn/manual/plugins/grib/grib-settings-bottom-slider.h.159_tok.e12382_w.550.jpg" class="media" alt="" width="550" height="159" />
</p>

<p>
The pressure display has no overlays, only the options of isobars and numbers.
Overlay Transparency is redundant.
</p>

<p>
<img src="../../opencpn/manual/plugins/grib/grib-settings-data-pressure.h.215_tok.74336a_w.550.jpg" class="media" alt="" width="550" height="215" />
<br/>

<img src="../../opencpn/manual/plugins/grib/grib-settings-bottom-slider.h.159_tok.e12382_w.550.jpg" class="media" alt="" width="550" height="159" />
</p>

<p>
Waves and Current have a more or less similar display. A Particle Map is available for currents. See the descripion above for wind Particle Maps. Once again different units.<br/>

There is a choice between three different display arrows shown in two sizes.<br/>

If wave height, direction and wave period is present in the grib file it will be displayed in the Display Control like this:
<br/>

<img src="../../opencpn/manual/plugins/grib/4gribcurrent_0.h.291_tok.1b6f98_w.317.jpg" class="media" alt="" width="317" height="291" />
<br/>

<img src="../../opencpn/manual/plugins/grib/grib-settings-data-waves-data.h.304_tok.b49886_w.550.jpg" class="media" alt="" width="550" height="304" />
<br/>

<img src="../../opencpn/manual/plugins/grib/grib-settings-bottom-slider.h.159_tok.e12382_w.550.jpg" class="media" alt="" width="550" height="159" />
</p>

<p>
Air Temperature and Sea Temperature looks the same.
</p>

<p>
<img src="../../opencpn/manual/plugins/grib/grib-settings-data-air-temperature.h.251_tok.7855a1_w.550.jpg" class="media" alt="" width="550" height="251" />
<br/>

<img src="../../opencpn/manual/plugins/grib/grib-settings-bottom-slider.h.159_tok.e12382_w.550.jpg" class="media" alt="" width="550" height="159" />
</p>

<p>
Convective Available Potential Energy (CAPE) has these settings
</p>

<p>
<img src="../../opencpn/manual/plugins/grib/grib-settings-data-cape.h.248_tok.723d67_w.550.jpg" class="media" alt="" width="550" height="248" />
<br/>

<img src="../../opencpn/manual/plugins/grib/grib-settings-bottom-slider.h.159_tok.e12382_w.550.jpg" class="media" alt="" width="550" height="159" />
<br/>

Altitude and Relative Humidity have a simple one choice entry.
</p>

</div>
<!-- EDIT15 SECTION "Display" [10013-14952] -->
<h3 class="sectionedit16" id="the_grib-file_request_button">The Grib-file Request Button</h3>
<div class="level3">
<ul>
<li class="level1"><div class="li"> Grib files can be requested directly from the plugin. The request is in the form of an email to SailDocs or ZyGrib. The requested grib file is also delivered via email as an attachment.</div>
</li>
<li class="level1"><div class="li"> The area for which data is requested defaults to the area visible on the screen, but the request area can be selected by other means as well. See more below.</div>
</li>
<li class="level1"><div class="li"> It&#039;s possible to request gribs from 4 different Grib prediction models when using Saildocs GFS, COAMPS, RTOFS and indirectly WW3. When you request “Waves” in GFS, Saildocs merge wavedata from WW3 into the delivered grib.</div>
</li>
<li class="level1"><div class="li"> The ZyGrib option can only deliver GFS gribs, which is the “standard” model for gribs.</div>
</li>
<li class="level1"><div class="li"> RTOFS gribs only contains current and water temperature data.</div>
</li>
<li class="level1"><div class="li"> COAMPS delivers wind and pressure with a higher resolution than GFS</div>
</li>
<li class="level1"><div class="li"> The minimum times between grib records are 3h for GFS and 6h for COAMPS &amp; RTOFS.</div>
</li>
<li class="level1"><div class="li"> GFS can be requested for 8 days ahead. An extended GFS request up to 16 days ahead is possible. This warning will pop up.</div>
</li>
</ul>

<p>
<img src="../../opencpn/manual/33gfs16.h.179_tok.52d3d8_w.501.jpg" class="media" alt="" width="501" height="179" />
<br/>

The same value for COAMPS is 3 days and RTOFS 6 days.
<br/>

</p>

<p>
There are two layouts of this dialog, depending on whether it is a request to SaiDocs or to ZyGrib. Some alternatives are only available from SailDocs, and some are only available from zyGrib. Alternatives not available are grayed out.
<br/>

<br/>

</p>

</div>

<h4 id="saildocs_request_form">SailDocs Request Form</h4>
<div class="level4">

<p>
<br/>

<img src="../../opencpn/manual/plugins/grib/grib-settings-message-saildocs.h.661_tok.e5c05b_w.572.jpg" class="media" alt="" width="572" height="661" />
</p>

<p>
Compose the request by picking parameters and data. Not all data are available for all choices of parameters. <br/>

For example, in the picture above “Wind Gusts” and “Current” are grayed out, as the are not available with GFS from SailDocs.
<br/>

When selecting <strong>“Moving Grib”</strong> the dialog expands and makes it possible to choose a speed and course. The selected grib forecast area will move, using these values, for each grib interval. The idea behind this is to minimize the download while still covering a longer passage.<br/>

Moving grib files are incompatible with interpolation, so if a “moving file” is detected a warning is displayed. Interpolation, if set is deactivated, but only for moving file, the settings as such, are not modified. 
<br/>

<strong>Resolution</strong> The choices are 0.5, 1.0 or 2.0. A recent upgrade to gribs makes it possible to download even 0.25&amp;deg; resolution. This is not yet an alternative in the plugin and requires editing the email manually before sending. In the picture above …|0.5,0.5|… should instead look like …|0.25,0.25|…
<br/>

The default geographical coverage of the requested grib file is the area you can see on the screen. A manual Selection Mode is also available. <br/>

When the<strong> Area Selection</strong> → Manual Selection box is ticked the dialog expands 
<br/>

</p>

<p>
<img src="../../opencpn/manual/plugins/grib/4gribareaselection.h.79_tok.833504_w.513.jpg" class="media" alt="" width="513" height="79" />
</p>

<p>
Choose the limiting Latitude and Longitude for the grib-file manually or press “Start graphic Sel.” button.
<br/>

</p>

<p>
<img src="../../opencpn/manual/plugins/grib/4gribgraph-selection.h.383_tok.9f66c1_w.481.jpg" class="media" alt="" width="481" height="383" />
</p>

<p>
Press the left mouse-button and draw a rectangle around the required area.
</p>

<p>
When selecting <strong>“Pressure Altitude”</strong> and the GFS forecast model, the dialog expands and makes it possible to choose forecasts for different altitude levels. The SailDocs dialog only supports the 500 mb altitude, while zyGrib suports all options.
<br/>

When you are ready press <strong><em>“Send”</em></strong>. 
<br/>

This message will show in the “Mail” window instead of the “send” request:
<br/>

</p>
<pre class="code">   Your request is ready. An email is prepared in your email environment.
   You have just to verify and send it...
   Save or Cancel to finish...or Continue...</pre>

<p>
<br/>

As stated, a mail is composed for you and ready to send with your normal mailing program.
<br/>

This is the standard way of getting a new grib in Windows and Linux. (Mac ??)
<br/>

</p>

<p>
To get a grib, just press <strong><em>“Send”</em></strong>, and wait for a return mail.
<br/>

<br/>

</p>

</div>

<h4 id="zygrib_request_form">zyGrib Request Form</h4>
<div class="level4">

<p>
<br/>

Note that the Login is longer the first page of the website. The <abbr title="Uniform Resource Locator">URL</abbr> for the login is <a href="http://www.zygrib.org/index.php?page=gribauto" class="urlextern" title="http://www.zygrib.org/index.php?page=gribauto" rel="nofollow">http://www.zygrib.org/index.php?page=gribauto</a>  This is where you login to recieve the special code that allows download for two months.
<br/>

<img src="../../opencpn/manual/plugins/grib/grib-settings-message-zygrib.h.692_tok.70fc7e_w.550.jpg" class="media" alt="" width="550" height="692" />
<br/>

</p>

</div>
<!-- EDIT16 SECTION "The Grib-file Request Button" [14953-19232] -->
<h3 class="sectionedit17" id="configuration_of_default_email_server">Configuration of Default Email Server</h3>
<div class="level3">

<p>
If after hitting “Send”, the “Mail” window shows this message, instead of the “send” request:
</p>
<pre class="code"> Request can&#039;t be sent. Please verify your email system parameters.
 You should also have a look at your log file.
 Save or Cancel to finish...</pre>

<p>
Configuration of the user&#039;s default Mail Server for the particular Operating System is required.
</p>

<p>
<strong>There is an advanced alternative</strong> for Mac OSX, Linux (and BSD). Install and configure a mail server. Instructions are on the <a href="grib_weather/mail_servers.html" class="wikilink1" title="opencpn:opencpn_user_manual:plugins:included_plugins:grib_weather:mail_servers">Grib Weather Mail Servers Page</a>. Following these instructions to enable the mail server will enable automatic transmission of a grib request to SailDocs.
</p>

<p>
After installing and configuring a mail server, there is one more step. Open “opencpn.conf” and add the line below. As always, do not run OpenCPN when editing opencpn.conf.
</p>
<pre class="code">   [PlugIns/GRIB]\\
   SendMailMethod=1</pre>

<p>
Setting “SendMailMethod” to “0” restores the default.
<br/>

</p>

</div>
<!-- EDIT17 SECTION "Configuration of Default Email Server" [19233-20266] -->
<h3 class="sectionedit18" id="zygrib_server_registration">ZyGrib Server Registration</h3>
<div class="level3">

<p>
When ZyGrib is selected as the download server, there are User and Code fields that can be completed. This requires subscription or registration to the ZyGrib Forum.
</p>

<p>
ZyGrib allows registration to the zyGrib forum and permits use of the user/password to obtain a two month code for registered zyGrib downloads. Limitations: Maximum 16 emails per user and per 24 hours. Maximum size of 4 <abbr title="Megabyte">MB</abbr> per grib file.
</p>
<ul>
<li class="level1"><div class="li"> <a href="http://www.zygrib.org/index.php?page=gribauto&amp;mode=form" class="urlextern" title="http://www.zygrib.org/index.php?page=gribauto&amp;mode=form" rel="nofollow">Request by Internet</a></div>
</li>
<li class="level1"><div class="li"> <a href="http://zygrib.org/index.php?page=gribauto&amp;mode=mail" class="urlextern" title="http://zygrib.org/index.php?page=gribauto&amp;mode=mail" rel="nofollow">Gribs by Email</a></div>
</li>
<li class="level1"><div class="li"> <a href="http://www.zygrib.org/index.php?page=gribauto" class="urlextern" title="http://www.zygrib.org/index.php?page=gribauto" rel="nofollow">Code Generator</a></div>
</li>
<li class="level1"><div class="li"> <a href="http://zygrib.org/forum/index.php?sid=961889a5354269828e9d83eb33007c99" class="urlextern" title="http://zygrib.org/forum/index.php?sid=961889a5354269828e9d83eb33007c99" rel="nofollow">Forum</a></div>
</li>
</ul>

</div>
<!-- EDIT18 SECTION "ZyGrib Server Registration" [20267-21024] -->
<h3 class="sectionedit19" id="load_two_grib_files_concurrently_wind_current">Load two Grib Files Concurrently (Wind + Current)</h3>
<div class="level3">

<p>
Combine separate Saildocs GFS Wind + RTOFS Current grib files.
(Note: Only applies to OpenCPN v4.2.x and forward)
<br/>

Using Windows, Click on the “Open a File” to browse grib file. 
</p>
<ol>
<li class="level1"><div class="li"> Highlight two grib files (Ctrl and pick the two files with a mouse left click.) </div>
</li>
<li class="level1"><div class="li"> The pick Open and the two grib files will be opened. </div>
</li>
<li class="level1"><div class="li"> Both grib files will be used by Weather_routing.</div>
</li>
<li class="level1"><div class="li"> In grib_pi settings I always use the “Current” “Proportional Arrow” </div>
</li>
</ol>

<p>
<img src="../../opencpn/manual/saildocscurrent.tok.38af4d_w.400.jpeg" class="media" alt="" width="400" /></a>
<br/>

</p>

</div>
<!-- EDIT19 SECTION "Load two Grib Files Concurrently (Wind + Current)" [21025-21719] -->
<h3 class="sectionedit20" id="more_to_know">More to know</h3>
<div class="level3">

<p>
There are many aspects to the use of grib files which lead to the use of other companion programs or plugins.
<br/>

</p>
<ul>
<li class="level1"><div class="li"> <a href="http://www.zygrib.org/index.php?page=abstract_en" class="urlextern" title="http://www.zygrib.org/index.php?page=abstract_en" rel="nofollow">ZyGrib</a> is a free and open-source software (<abbr title="Free &amp; Open-Source Software">FOSS</abbr>) dedicated grib viewer. Grib files can be downloaded by ZyGrib and then opened in OpenCPN.</div>
</li>
<li class="level1"><div class="li"> <a href="http://wiki.virtual-loup-de-mer.org/index.php/QtVlm/en" class="urlextern" title="http://wiki.virtual-loup-de-mer.org/index.php/QtVlm/en" rel="nofollow">QtVlm</a>, is another <abbr title="Free &amp; Open-Source Software">FOSS</abbr> weather routing program, combines a grib file with boat polar data, and produces an optimized route. </div>
</li>
</ul>

<p>
<br/>

These are very good tools to use in routing decisions, but they all have the same limitations as all grib-data.
<br/>

</p>

</div>
<!-- EDIT20 SECTION "More to know" [21720-22855] -->
<h3 class="sectionedit21" id="grib_file_notes_warnings">Grib File Notes &amp; WARNINGS</h3>
<div class="level3">

<p>
(These notes are from the SailDocs Grib Server)
</p>

<p>
This grib file is extracted from a computer forecast model. While such computer data can provide useful guidance for general wind flow, there are limitations which must be understood. 
</p>

<p>
What you are receiving is a weather prediction generated by a computer run by NOAA/NCEP (GFS, WW3 models) or the US Navy (comaps, nogaps) and downloaded and processed by Saildocs (a service of Sailmail). 
</p>

<p>
The network is complex, and any computer network is subject to hardware and software failures or human error 
which can effect accuracy or availability of data. 
</p>
<ol>
<li class="level1"><div class="li"> In particular, if our servers were not able to download a current data file then the grib-file may be based on old data. The file information is shown above and also contained in the file itself. Also remember that grib data is not reviewed by forecasters before being made available. </div>
</li>
<li class="level1"><div class="li"> You are getting a small part of the raw model data that the forecasters themselves use when writing a forecast, and it is your responsibility to make sure that the data is consistent with your local conditions and with the professionally-generated forecasts (e.g. text bulletins and weather-fax charts). </div>
</li>
<li class="level1"><div class="li"> Grib data also has limitations along shore, where local effects often dominate and may not be adequately modeled. </div>
</li>
<li class="level1 node"><div class="li"> In addition these models cannot provide adequate prediction for </div>
<ul>
<li class="level2"><div class="li"> tropical systems, </div>
</li>
<li class="level2"><div class="li"> frontal activity or convergence zones. </div>
</li>
<li class="level2"><div class="li"> For example, while global models can provide useful data on the likely track of hurricanes, they grossly underestimate the strength of hurricanes because of their small size compared to the model grid. </div>
</li>
</ul>
</li>
<li class="level1"><div class="li"> For hurricane/cyclone forecasts, carefully monitor the appropriate warning messages and do not rely on grib data from any source. </div>
</li>
</ol>

<p>
Grib data can provide useful guidance not available elsewhere. Understand the limitations and use the data carefully. Grib data should be considered supplemental to other forecasts, and not be relied upon in lieu of professionally-generated charts or forecasts. 
</p>

</div>
<!-- EDIT21 SECTION "Grib File Notes & WARNINGS" [22856-] -->
<!-- no cachefile used, but created /var/www/html/dokuwiki/data/cache/6/60cb57de521ef65d36678bb55a2bc325.xhtml -->
</div>
</body>
</html>
